FilesContents Figures, Tables, and ListingsAbout This Book Format of a Typical Chapter Conventions Used in This BookSpecial FontsTypes of Notes Assembly-Language InformationDevelopment Environment Introduction to File Management About Files
File Forks,Figure 1-1 The two forks of a Macintosh file File Size/Figure 1-2 Logical blocks and allocation blocks7Figure 1-3 Logical end-of-file and physical end-of-fileFile Access Characteristics The Hierarchical File System1Figure 1-4 The Macintosh hierarchical file system%Figure 1-5 The disk switch dialog box!Identifying Files and Directories Using Files Figure 1-6 A typical File menu+Listing 1-1 Handling the File menu commands$Testing for File Management RoutinesSListing 1-2 Testing for the availability of routines that operate on FSSpec recordsDefining a Document Record$Listing 1-3 A sample document recordCreating a New File)Listing 1-4 Handling the New menu command*Listing 1-5 Creating a new document windowOpening a File*Listing 1-6 Handling the Open menu command&Figure 1-7 The default Open dialog boxListing 1-7 Opening a fileReading File Data$Listing 1-8 Reading data from a fileWriting File Data$Listing 1-9 Writing data into a file#Listing 1-10 Updating a file safelySaving a File+Listing 1-11 Handling the Save menu command.Listing 1-12 Handling the Save As menu command&Figure 1-8 The default Save dialog box$Figure 1-9 The new folder dialog box(Figure 1-10 The name conflict dialog boxAListing 1-13 Copying a resource from one resource fork to anotherReverting to a Saved File(Figure 1-11 A Revert to Saved dialog box6Listing 1-14 Handling the Revert to Saved menu commandClosing a File,Listing 1-15 Handling the Close menu commandListing 1-16 Closing a file)Opening Files at Application Startup Time5Listing 1-17 Opening files at application launch timeUsing a Preferences File'Listing 1-18 Opening a preferences fileAdjusting the File Menu$Listing 1-19 Adjusting the File menuFile Management ReferenceData Structures File System Specification RecordStandard File Reply RecordsApplication Files RecordsFile Specification RoutinesStandardGetFileStandardPutFileFile Access Routines#Reading, Writing, and Closing FilesFSReadFSWriteFSCloseManipulating the File MarkGetFPosSetFPos Manipulating the End-of-FileGetEOFSetEOF(File and Directory Manipulation Routines%Opening, Creating, and Deleting Files FSpOpenDF FSpCreate FSpDelete Exchanging the Data in Two FilesFSpExchangeFiles#Creating File System Specifications FSMakeFSSpecVolume Access RoutinesUpdating VolumesFlushVol Obtaining Volume InformationGetVInfo
GetVRefNum Application Launch File Routines GetAppParmsCountAppFiles GetAppFiles ClrAppFilesSummary of File Management File ManagerAbout the File ManagerFile Manipulation)Table 2-1 Routines for opening file forks3Table 2-2 Routines for operating on open file forks0Table 2-3 Routines for operating on closed filesDirectory Manipulation/Table 2-4 Routines for operating on directories7Table 2-5 Routines for manipulating working directoriesVolume Manipulation+Table 2-6 Routines for operating on volumesVolume Searching7Table 2-7 Routines for manipulating working directoriesShared Environments%Table 2-8 Shared environment routines Shared File Access Permissions/Figure 2-1 Access and deny mode synchronization!Table 2-9 Access mode translationDirectory Access Privileges@Figure 2-2 Access privileges information in the ioACAccess fieldRemote Volume Mounting-Privilege Information in Foreign File SystemsFile ID Reference Routines+Identifying Files, Directories, and VolumesFile System SpecificationsFile IDsDirectory IDsVolume Reference Numbers#Working Directory Reference NumbersNames and PathnamesHFS Specifications$Figure 2-3 Identifying a file in HFS Search PathsUsing the File Manager,Determining the Features of the File Manager#Listing 2-1 Testing for PBCatSearch*Creating File System Specification Records5Table 2-10 How FSMakeFSSpec interprets its parameters-Manipulating the Default Volume and Directory Deleting Files and File Forks+Listing 2-2 Deleting a file’s resource forkSearching a VolumeDTable 2-11 Fields in ioSearchInfo1 and ioSearchInfo2 used for a fileITable 2-12 Fields in ioSearchInfo1 and ioSearchInfo2 used for a directory/Listing 2-3 Searching a volume with PBCatSearch@Listing 2-4 Searching a volume using a recursive, indexed searchConstructing Full Pathnames4Listing 2-5 Constructing the full pathname of a file0Determining the Amount of Free Space on a Volume<Listing 2-6 Determining the amount of free space on a volume Sharing Volumes and Directories4Listing 2-7 Determining whether a volume is sharable7Listing 2-8 Determining whether file sharing is enabled!Locking and Unlocking File Ranges=Listing 2-9 Determining whether a file can have ranges locked<Listing 2-10 Locking a file range to append data to the file Data Organization on Volumes Disk and Volume Organization/Figure 2-4 Organization of partitions on a disk#Figure 2-5 Organization of a volume Boot BlocksMaster Directory BlocksVolume BitmapsB*-Trees*Figure 2-6 The structure of a B*-tree fileNodes"Figure 2-7 The structure of a node Node Records-Figure 2-8 Structure of a B*-tree node recordFigure 2-9 A sample B*-tree Header Nodes!Figure 2-10 Header node structure Map Nodes Index Nodes
Leaf NodesCatalog FilesCatalog File KeysCatalog File Data RecordsExtents Overflow FilesData Organization in MemoryThe File I/O QueueVolume Control BlocksFile Control BlocksB*-Tree Control BlocksThe Drive Queue7Listing 2-11 Reading a drive queue element’s flag bytesFile Manager ReferenceData Structures File System Specification Record"Basic File Manager Parameter BlockHFS Parameter Block$Catalog Information Parameter BlocksCatalog Position Records Catalog Move Parameter Blocks"Working Directory Parameter Blocks#File Control Block Parameter BlocksVolume Attributes Buffer#Volume Mounting Information Records High-Level File Access Routines#Reading, Writing, and Closing FilesFSReadFSWriteFSCloseManipulating the File MarkGetFPosSetFPos Manipulating the End-of-FileGetEOFSetEOFAllocating File BlocksAllocate AllocContig Low-Level File Access Routines#Reading, Writing, and Closing FilesPBReadPBWritePBCloseManipulating the File Mark PBGetFPos PBSetFPos Manipulating the End-of-FilePBGetEOFPBSetEOFAllocating File Blocks
PBFlushVol Obtaining Volume Information PBHGetVInfo
PBSetVInfoPBHGetVolParms Manipulating the Default VolumePBGetVolPBSetVol PBHGetVol PBHSetVol"File System Specification RoutinesOpening Files FSpOpenDF FSpOpenRF+Creating and Deleting Files and Directories FSpCreate FSpDirCreate FSpDelete1Accessing Information About Files and Directories FSpGetFInfo FSpSetFInfo FSpSetFLock FSpRstFLock FSpRenameMoving Files or Directories
FSpCatMove Exchanging the Data in Two FilesFSpExchangeFiles#Creating File System Specifications FSMakeFSSpec PBMakeFSSpecHigh-Level HFS RoutinesOpening FilesHOpenDFHOpenRFHOpen+Creating and Deleting Files and DirectoriesHCreate DirCreateHDelete1Accessing Information About Files and Directories HGetFInfo HSetFInfo HSetFLock HRstFLockHRenameMoving Files or DirectoriesCatMove Maintaining Working DirectoriesOpenWDCloseWD GetWDInfoLow-Level HFS RoutinesOpening Files PBHOpenDF PBHOpenRFPBHOpen+Creating and Deleting Files and Directories PBHCreate PBDirCreate PBHDelete1Accessing Information About Files and Directories PBGetCatInfo PBSetCatInfo PBHGetFInfo PBHSetFInfo PBHSetFLock PBHRstFLock PBHRenameMoving Files or Directories PBCatMove Maintaining Working DirectoriesPBOpenWD PBCloseWD PBGetWDInfoSearching a Catalog PBCatSearch Exchanging the Data in Two FilesPBExchangeFilesShared Environment Routines"Opening Files While Denying Access PBHOpenDenyPBHOpenRFDeny!Locking and Unlocking File Ranges PBLockRangePBUnlockRangeManipulating Share PointsPBShare PBUnshare PBGetUGEntry Controlling Directory AccessPBHGetDirAccessPBHSetDirAccessMounting VolumesPBGetVolMountInfoSizePBGetVolMountInfoPBVolumeMountControlling Login AccessPBHGetLogInInfoPBHMapID
PBHMapNameCopying and Moving Files PBHCopyFilePBHMoveRenameFile ID Routines Resolving File ID ReferencesPBResolveFileIDRef(Creating and Deleting File ID ReferencesPBCreateFileIDRefPBDeleteFileIDRef Foreign File System RoutinesPBGetForeignPrivsPBSetForeignPrivsUtility RoutinesObtaining Queue Headers GetFSQHdr
GetVCBQHdr
GetDrvQHdrAdding a DriveAddDrive(Obtaining File Control Block Information PBGetFCBInfo Application-Defined RoutinesCompletion RoutinesMyCompletionProc Summary of the File ManagerStandard File Package About the Standard File PackageStandard User InterfacesOpening Files&Figure 3-1 The default Open dialog box Saving Files&Figure 3-2 The default Save dialog box$Figure 3-3 The New Folder dialog box'Figure 3-4 The name conflict dialog boxKeyboard EquivalentsCustomized User Interfaces Saving Files<Figure 3-5 The Save dialog box customized with radio buttons<Figure 3-6 The Save dialog box customized with a pop-up menuOpening Files<Figure 3-7 The Open dialog box customized with a pop-up menu!Selecting Volumes and DirectoriesKFigure 3-8 The Open dialog box customized to allow selection of a directory<Figure 3-9 The Open dialog box when no directory is selectedFFigure 3-10 The Open dialog box with a long directory name abbreviated)Figure 3-11 A volume selection dialog boxUser Interface Guidelines Using the Standard File Package&Presenting the Standard User Interface*Listing 3-1 Handling the Open menu command0Listing 3-2 Specifying more than four file types Customizing the User Interface3Listing 3-3 Presenting a customized Open dialog boxCustomizing Dialog Boxes9Listing 3-4 The definition of the default Open dialog box9Listing 3-5 The definition of the default Save dialog box9Listing 3-6 The item list for the default Open dialog box9Listing 3-7 The item list for the default Save dialog box Writing a File Filter Function)Listing 3-8 A sample file filter function Writing a Dialog Hook Function)Listing 3-9 A sample dialog hook function&Writing a Modal-Dialog Filter Function2Listing 3-10 A sample modal-dialog filter function Writing an Activation Procedure Setting the Current Directory.Listing 3-11 Determining the current directory+Listing 3-12 Determining the current volume*Listing 3-13 Setting the current directory'Listing 3-14 Setting the current volume*Listing 3-15 Setting the current directorySelecting a Directory?Listing 3-16 A file filter function that lists only directories%Listing 3-17 Setting a button’s titleKListing 3-18 Handling user selections in the directory selection dialog box:Listing 3-19 Presenting the directory selection dialog boxSelecting a Volume;Listing 3-20 A file filter function that lists only volumesHListing 3-21 Handling user selections in the volume selection dialog box7Listing 3-22 Presenting the volume selection dialog box Using the Original Procedures Standard File Package ReferenceData Structures#Enhanced Standard File Reply Record#Original Standard File Reply Record Standard File Package Routines Saving FilesStandardPutFileCustomPutFile SFPutFile
SFPGetFile Application-Defined RoutinesFile Filter FunctionsMyStandardFileFilterMyCustomFileFilterDialog Hook Functions MyDlgHook Modal-Dialog Filter FunctionsMyModalFilterMyModalFilterYDActivation ProceduresMyActivateProc%Summary of the Standard File PackageAlias ManagerAbout the Alias ManagerAlias RecordsSearch StrategiesRelative Searches$Figure 4-1 Resolving a relative pathAbsolute SearchesFast SearchesExhaustive SearchesUsing the Alias ManagerCreating Alias Records$Listing 4-1 Creating an alias recordResolving Alias RecordsIdentifying a Single Target Identifying Multiple TargetsMaintaining Alias Records1Listing 4-2 Storing an alias record as a resource&Getting Information From Alias RecordsCustomizing Alias RecordsAlias Manager ReferenceData StructuresAlias RecordsAlias Manager Routines#Creating and Updating Alias Records#Resolving and Reading Alias Records Application-Defined RoutinesFiltering Possible Targets Summary of the Alias ManagerDisk Initialization Manager%About the Disk Initialization ManagerDisk Initialization&The Disk Initialization User Interface-Figure 5-1 The disk initialization dialog boxCFigure 5-2 Alternate buttons for the disk initialization dialog box*Figure 5-3 The disk initialization warning%Figure 5-4 The disk naming dialog box/Figure 5-5 The Finder’s disk erasing dialog boxBad Block Sparing%Using the Disk Initialization Manager"Responding to Disk-Inserted Events.Listing 5-1 Responding to disk-inserted eventsErasing Initialized Disks'Listing 5-2 Reinitializing a valid disk0Overriding the Standard Initialization InterfaceXListing 5-3 Reinitializing a validly formatted disk without using the standard interfaceSListing 5-4 Initializing an uninitialized disk without using the standard interface'Changing Default Volume Characteristics3Listing 5-5 Changing default volume characteristics%Disk Initialization Manager ReferenceRoutines5Loading and Unloading the Disk Initialization ManagerDILoadDIUnloadInitializing a Disk
DIBadMount&Low-Level Disk Initialization RoutinesDIFormatDIVerifyDIZero+Summary of the Disk Initialization ManagerGlossaryIndex
